home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldgetpd.z / ldgetpd
Encoding:
Text File  |  2002-10-03  |  2.0 KB  |  53 lines

  1. LDGETPD(3X)                                           Last changed: 11-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      llddggeettppdd - Retrieves procedure descriptor given a procedure descriptor
  6.      index
  7.  
  8. SSYYNNOOPPSSIISS
  9.      ##iinncclluuddee <<ssttddiioo..hh>>
  10.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  11.      ##iinncclluuddee <<ssyymm..hh>>
  12.      ##iinncclluuddee <<llddffccnn..hh>>
  13.  
  14.      lloonngg llddggeettppdd ((""_l_d_p_t_r,, iippdd,,_p_p_d""))
  15.      LLDDFFIILLEE _l_d_p_t_r;;
  16.      lloonngg _i_p_d;;
  17.      ppPPDDRR _p_p_d;;
  18.  
  19. IIMMPPLLEEMMEENNTTAATTIIOONN
  20.      IRIX systems (o32 ABI only)
  21.  
  22. DDEESSCCRRIIPPTTIIOONN
  23.      llddggeettppdd returns a SUCCESS or FAILURE depending on whether the
  24.      procedure descriptor with index _i_p_d can be accessed.  If it can be
  25.      accessed, the structure pointed to by _p_p_d is filled with the contents
  26.      of the corresponding procedure descriptor.  The _i_s_y_m, _i_l_i_n_e, and _i_o_p_t
  27.      fields of the procedure descriptor are updated to be used in further
  28.      LD routine calls.  The _a_d_r field is updated from the symbol referenced
  29.      by the _i_s_y_m field.
  30.  
  31.      The PDR cannot be retrieved when:
  32.  
  33.      * The procedure descriptor table cannot be found.
  34.  
  35.      * The _i_p_d offset into the procedure descriptor table is beyond the end
  36.        of the table.
  37.  
  38.      * The file descriptor that the _i_p_d offset falls into cannot be found.
  39.  
  40.      Typically, llddggeettppdd is called while traversing the table that runs from
  41.      0 to SSYYMMHHEEAADDEERR((llddppttrr))..iippddMMaaxx -- 11.
  42.  
  43.      The program must be loaded with the object file access routine library
  44.      lliibbmmlldd..aa.
  45.  
  46. SSEEEE AALLSSOO
  47.      llddcclloossee(3X), llddooppeenn(3X), llddttbbrreeaadd(3X), llddttbbsseeeekk(3X)
  48.  
  49.      llddffccnn(4)
  50.  
  51.      This man page is available only online.
  52.  
  53.